package com.anpy.album.mapper;

import com.anpy.album.entity.CalendarEvent;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 日历事件 Mapper 接口
 */
@Mapper
public interface CalendarEventMapper {
    
    /**
     * 插入新的日历事件
     * 
     * @param event 日历事件对象
     * @return 影响的行数
     */
    int insert(CalendarEvent event);
    
    /**
     * 根据ID更新日历事件
     * 
     * @param event 日历事件对象
     * @return 影响的行数
     */
    int updateById(CalendarEvent event);
    
    /**
     * 根据ID删除日历事件
     * 
     * @param id 事件ID
     * @return 影响的行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 根据ID查询日历事件
     * 
     * @param id 事件ID
     * @return 日历事件对象
     */
    CalendarEvent selectById(@Param("id") Long id);
    
    /**
     * 根据用户ID查询所有日历事件
     * 
     * @param userId 用户ID
     * @return 日历事件列表
     */
    List<CalendarEvent> selectByUserId(@Param("userId") Long userId);
    
    /**
     * 根据用户ID和时间范围查询日历事件
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 日历事件列表
     */
    List<CalendarEvent> selectByUserIdAndTimeRange(
            @Param("userId") Long userId,
            @Param("startTime") LocalDateTime startTime,
            @Param("endTime") LocalDateTime endTime);
    
    /**
     * 根据用户ID和事件类型查询日历事件
     * 
     * @param userId 用户ID
     * @param eventType 事件类型
     * @return 日历事件列表
     */
    List<CalendarEvent> selectByUserIdAndEventType(
            @Param("userId") Long userId,
            @Param("eventType") Integer eventType);
    
    /**
     * 根据用户ID查询指定日期的日历事件
     * 
     * @param userId 用户ID
     * @param date 日期
     * @return 日历事件列表
     */
    List<CalendarEvent> selectByUserIdAndDate(
            @Param("userId") Long userId,
            @Param("date") LocalDateTime date);
}
